From 96af68529bfdd0eeecaa8bc3caa7bb03576b1e5f Mon Sep 17 00:00:00 2001 From: Matthias Clasen Date: Wed, 26 Jan 2011 18:19:35 -0500 Subject: [PATCH] Document that gtk_widget_queue_draw_area is in widget coordinates --- gtk/gtkwidget.c | 8 +++++++- 1 file changed, 7 insertions(+), 1 deletion(-) diff --git a/gtk/gtkwidget.c b/gtk/gtkwidget.c index 9ce1c8cdb2..00343bfb5f 100644 --- a/gtk/gtkwidget.c +++ b/gtk/gtkwidget.c @@ -4503,7 +4503,13 @@ gtk_widget_queue_draw_region (GtkWidget *widget, * * Convenience function that calls gtk_widget_queue_draw_region() on * the region created from the given coordinates. - **/ + * + * The region here is specified in widget coordinates. + * Widget coordinates are a bit odd; for historical reasons, they are + * defined as @widget->window coordinates for widgets that are not + * #GTK_NO_WINDOW widgets, and are relative to @widget->allocation.x, + * @widget->allocation.y for widgets that are #GTK_NO_WINDOW widgets. + */ void gtk_widget_queue_draw_area (GtkWidget *widget, gint x, -- 2.30.2